---
title: logstash docs for <%= section %>s/<%= name %>
layout: content_right
---
<h2><%= name %></h2>
<h3>Milestone: <a href="../plugin-milestones"><%= @milestone %></a></h3>
<% if is_contrib_plugin -%>
<% end -%>

<%= description %>

<h3> Synopsis </h3>

A sample configuration file is shown here:

<pre><code><% if section == "codec" -%>
# with an input plugin:
# you can also use this codec with an output.
input { 
<% if name == "json_lines" -%>
  udp {
    port =&gt; 1234
<% else -%>
  file {
<% end -%>
    codec =&gt; <%= synopsis -%>
  }
}
<% else -%>
<%= section %> {
  <%= synopsis -%>
}
<% end -%></code></pre>

<h3> Details </h3>

<% sorted_attributes.each do |name, config| -%>
<%
     if name.is_a?(Regexp)
       name = "/" + name.to_s.gsub(/^\(\?-mix:/, "").gsub(/\)$/, "") + "/"
       is_regexp = true
     else
       is_regexp = false
     end
-%>
<h4> 
  <a name="<%= name %>">
    <%= name %><%= " (required setting)" if config[:required] %>
    <%= " <strong>DEPRECATED</strong>" if config[:deprecated] %>
</a>
</h4>

<ul>
<% if config[:deprecated] -%>
  <li> DEPRECATED WARNING: This configuration item is deprecated and may not be included in later versions.</li>
<% end -%>
<% if is_regexp -%>
  <li> The configuration attribute name here is anything that matches the above regular expression. </li>
<% end -%>
<% if config[:validate].is_a?(Symbol) -%>
  <li> Value type is <a href="../configuration#<%= config[:validate] %>"><%= config[:validate] %></a> </li>
<% elsif config[:validate].nil? -%>
  <li> Value type is <a href="../configuration#string">string</a> </li>
<% elsif config[:validate].is_a?(Array) -%>
  <li> Value can be any of: <%= config[:validate].map(&:inspect).join(", ") %> </li>
<% end -%>
<% if config.include?(:default) -%>
  <li> Default value is <%= config[:default].inspect %> </li>
<% else -%>
  <li> There is no default value for this setting. </li>
<% end -%>
</ul>

<%= config[:description] %>

<% end -%>

<hr>

This is documentation from <a href="https://github.com/logstash/logstash/blob/v<%= LOGSTASH_VERSION %>/<%= file %>"><%= file %></a>
